home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / doors_1 / connct10.zip / CONNECT.TXT < prev   
Text File  |  1990-09-26  |  14KB  |  462 lines

  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.                                   Connect v1.00
  24.  
  25.                         Qmail <--> FrontDoor FileAttacher
  26.  
  27.                           Copyright 1990 by Jim Nikolich
  28.  
  29.                                All rights reserved
  30.  
  31.                                 By James Nikolich
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71.  
  72.  
  73.  
  74.  
  75.  
  76.  
  77.                           T A B L E   O F   C O N T E N T S
  78.                          -----------------------------------
  79.  
  80.  
  81.            LICENCE .................................................. 3
  82.  
  83.            TRADEMARKS ............................................... 3
  84.  
  85.            WHAT IS CONNECT? ......................................... 4
  86.  
  87.            HOW CONNECT WORKS ........................................ 4
  88.  
  89.            INSTALLATION ............................................. 4
  90.  
  91.                Systems Without Passthru Areas ....................... 4
  92.  
  93.                Systems With Passthru Areas .......................... 6
  94.  
  95.            CONNECT.CTL VERBS ........................................ 7
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.  
  131.                       Connect v1.00  Documentation  ---  Page 2
  132.  
  133.  
  134.  
  135.  
  136.  
  137.        LICENCE
  138.  
  139.        Copyright 1990 by James D. Nikolich.  All rights reserved.
  140.  
  141.        Connect is distributed on a non-commercial basis.  Commercial
  142.        distribution prohibited without express written consent from the author.
  143.        Modification of the Connect source, documentation, or executable code
  144.        is expressly prohibited.
  145.  
  146.  
  147.  
  148.                                        WARRANTY
  149.  
  150.        IN NO EVENT SHALL JAMES D. NIKOLICH OR ANY OTHER PARTY BE LIABLE TO YOU
  151.        OR ANYONE ELSE FOR ANY DAMAGES, INCLUDING ANY LOST PROFITS, LOST
  152.        SAVINGS, OR OTHER SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING
  153.        OUT OF THE USE OR INABILITY TO USE CONNECT, EVEN IF YOU HAVE BEEN
  154.        ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.  THE ENTIRE RISK AS TO THE
  155.        QUALITY AND PERFORMANCE OF CONNECT AND THE ACCURACY OF ITS DOCUMENTATION
  156.        RESTS WITH YOU.  SHOULD CONNECT OR ITS ASSOCIATED DOCUMENTATION PROVE
  157.        DEFECTIVE, YOU ASSUME THE FULL COST OF ALL NECESSARY SERVICING, REPAIR,
  158.        OR CORRECTION.
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.        TRADEMARKS
  169.  
  170.        Acknowledgement is given to the trademarks and products mentioned in
  171.        this documentation.  Use of these names or trademarks does not suggest
  172.        any affiliation with the specified products.  The names or trademarks
  173.        referred to are used for reference purposes only.
  174.  
  175.        FrontDoor and TosScan       Joaquim Homrighausen.
  176.  
  177.        Opus-CBCS                   Wynn Wagner III.
  178.  
  179.        ConfMail and oMMM           Bob Hartman, Spark Software.
  180.  
  181.        Qmail                       Greg Dawson.
  182.  
  183.        BinkleyTerm                 Bob Hartman and Vince Perriello, BBS Inc.
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.  
  196.  
  197.                       Connect v1.00  Documentation  ---  Page 3
  198.  
  199.  
  200.  
  201.  
  202.  
  203.        WHAT IS CONNECT?
  204.  
  205.            Anybody using FrontDoor as a mailer will probably find that they
  206.        have quite a small selection of echomail-handling programs from which to
  207.        choose.  They can use Confmail, an obsolete program that supports
  208.        neither passthru areas nor multiple zones.  Alternatively They can spend
  209.        $45.00 (U.S. dollars) plus shipping and handling for a copy of TosScan,
  210.        written by the author of Frontdoor.  Prior to Connect, these were about
  211.        the only choices a sysop had.
  212.  
  213.             Connect was written to allow users of FrontDoor to implement Qmail
  214.        as their echomail handler.  Although Qmail might be a bit confusing to
  215.        install, it is a competent program used world-wide, and supports
  216.        passthru areas, multiple zones, multiple AKA's in seenbys, zonegating,
  217.        tiny-seenbys and a host of other features.
  218.  
  219.  
  220.  
  221.        HOW CONNECT WORKS
  222.  
  223.             Qmail is capable only of generating oMMM-style .FLO, .CLO, .DLO and
  224.        .HLO files (referred to as "Flow files") for use with Binkley and Opus-
  225.        style mailers.  FrontDoor instead requires that a file-attach message be
  226.        created for every file to be transmitted and doesn't even notice the FLO
  227.        files as used by Qmail.  That's where Connect comes in - Connect will
  228.        scan the outbound directories used by Qmail, and generate file-attach
  229.        messages for any files waiting to go out.  Connect will only create new
  230.        messages if the file is attached to no other message already.  Connect
  231.        will also delete the unnecessary Flow files.  In order to keep Qmail
  232.        from scanning the netmail directory and packing up any messages found
  233.        into outbound packets, Qmail is directed to a dummy directory which
  234.        should never contain any files.
  235.  
  236.  
  237.  
  238.        INSTALLATION
  239.  
  240.             These installation instructions require that you already be
  241.        familiar with the operation of Qmail and FrontDoor.  Please refer to
  242.        their respective manuals for information on how to get them installed
  243.        and running.
  244.  
  245.             Two installation procedures are outlined:  one for systems with
  246.        passthru areas, and one for those without passthru areas.  Generally
  247.        speaking you will not normally have any passthru areas unless you act
  248.        as some kind of echomail hub or routing system, in which case the
  249.        first set of instructions will be the ones for you.  Please Refer to the
  250.        Qmail documentation for more information on what passthru areas are and
  251.        how they are used.
  252.  
  253.  
  254.  
  255.        Systems Without Passthru Areas
  256.  
  257.        Step 1.
  258.                  Copy CONNECT.EXE and CONNECT.CTL into your FrontDoor
  259.             directory.
  260.  
  261.  
  262.  
  263.                       Connect v1.00  Documentation  ---  Page 4
  264.  
  265.  
  266.  
  267.  
  268.  
  269.        Step 2.
  270.                  Create a new subdirectory under your FrontDoor directory.
  271.             This can be any name you choose, although "DUMDIR" will be used in
  272.             the following examples.
  273.  
  274.        Step 3.
  275.                  If you've ever used Qmail before, you'll be aware that you
  276.             need to run Qmail separately with a different configuration file
  277.             for each zone you operate in; otherwise your seenby lines will be
  278.             carried over from one zone to the other. If you haven't already
  279.             done so, make a configuration file for each zone.  Make a second
  280.             copy of each Qmail configuration file you have for future use.
  281.             The following examples will use "IMEXTOSS.CFG" and "FIDOTOSS.CFG"
  282.             as the original files, and "IMEXPACK.CFG and "FIDOPACK.CFG" as the
  283.             new copies.
  284.  
  285.        Step 4.
  286.                  Modify each of the new config files you've made so that the
  287.             "NetMail" option within each of them points to the subdirectory you
  288.             created under your FrontDoor directory instead of your real Netmail
  289.             directory.  THIS IS IMPERATIVE!  Otherwise Qmail will be able to
  290.             get at the messages in your Netmail directory, packing them up into
  291.             more outbound files and deleting the messages.  The end result
  292.             would be an endless loop with Qmail making up files from netmail
  293.             messages, and Connect Making more file-attach messages.
  294.  
  295.        Step 5.
  296.                  Create a Connect control file.  CONNECT.CTL is provided as an
  297.             example.  Refer to "CONNECT.CTL VERBS" for more information.  Note:
  298.             if you operate in more than one zone, you will have to create a
  299.             separate control file for each zone.  The following examples use
  300.             "CON_FIDO.CTL" and "CON_IMEX.CTL" as the filenames of the control
  301.             files.
  302.  
  303.        Step 6.
  304.                  At this point, you've finished installing Connect.  All that
  305.             remains is to write the batch files that will run Qmail and
  306.             Connect.  An example is provided to illustrate the usage.
  307.             DOMAIL1.BAT will toss, scan and pack waiting echomail for two
  308.             zones.  No other batch files are required, however you may wish to
  309.             split up the operations of DOMAIL1.BAT into separate batch files,
  310.             namely to execute the "Toss" pass separate from the "Scan Pack"
  311.             pass.  This would allow you to import incoming mail at different
  312.             times than when you check for new mail originating on your system.
  313.  
  314.                           DOMAIL1.BAT
  315.  
  316.             qm toss -cFIDOTOSS.CFG -aFIDOAREA.BBS
  317.             qm scan pack -cFIDOPACK.CFG -aFIDOAREA.BBS -sNORMAL_MAIL
  318.             connect CON_FIDO.CTL
  319.             qm toss -cIMEXTOSS.CFG -aIMEXAREA.BBS
  320.             qm scan pack -cIMEXPACK.CFG -aIMEXAREA.BBS -sNORMAL_MAIL
  321.             connect CON_IMEX.CTL
  322.  
  323.  
  324.  
  325.                  DOMAIL1.BAT first runs Qmail in "Toss" mode which will extract
  326.             any incoming echomail you may have and place it in its proper
  327.  
  328.  
  329.                       Connect v1.00  Documentation  ---  Page 5
  330.  
  331.  
  332.  
  333.  
  334.  
  335.             echomail area(s).  FIDOAREA.BBS is the  file that contains all the
  336.             echomail information for that zone.
  337.  
  338.                  Next Qmail is run in "Scan Pack" mode which will check your
  339.             echomail areas and export any echomail waiting to be passed on.
  340.             NORMAL_MAIL is the tag of the schedule used to control packing as
  341.             defined in your Qmail Routing file (typically QM_ROUTE.CFG).
  342.  
  343.                  Connect is then run, generating file attach messages for any
  344.             newly-created outbound mail packets.  The whole process is then
  345.             repeated using the second zone's set of control files.
  346.  
  347.  
  348.  
  349.        Systems With Passthru Areas
  350.  
  351.        Steps 1 - 5.
  352.                  Steps one through five are the same as those described in the
  353.             section "Systems Without Passthru Areas".
  354.  
  355.        Step 6.
  356.                  At this point, you've finished installing Connect.  All that
  357.             remains is to write the batch files that will run Qmail and
  358.             Connect.  The following example is provided to illustrate the
  359.             usage.  DOMAIL2.BAT will toss, scan and pack waiting echomail for
  360.             two zones, taking special consideration for any passthru areas that
  361.             may exist.  No other batch files are required however you may wish
  362.             to split up the operations of DOMAIL2.BAT into separate batch
  363.             files, namely to execute the "Toss Scan" pass separately from the
  364.             "Scan" and " Pack" passes.  This would allow you to handle incoming
  365.             mail at different times than when you check for new mail
  366.             originating on your system.  If so, insure that you run Qmail in
  367.             "Pack" mode followed by Connect immediately after each time you
  368.             "Toss Scan" and "Scan Pack".
  369.  
  370.                              DOMAIL2.BAT
  371.  
  372.             qm toss scan -cFIDOTOSS.CFG -aFIDOAREA.BBS
  373.             qm scan -cFIDOTOSS.CFG -aFIDOAREA.BBS
  374.             qm pack -cFIDOPACK.CFG -sNORMAL_MAIL
  375.             connect CON_FIDO.CTL
  376.             qm toss scan -cIMEXTOSS.CFG -aIMEXAREA.BBS
  377.             qm scan -cIMEXTOSS.CFG -aIMEXAREA.BBS
  378.             qm pack -cIMEXPACK.CFG -sNORMAL_MAIL
  379.             connect CON_FIDO.CTL
  380.  
  381.  
  382.  
  383.                  First Qmail is run in "Toss Scan" mode which imports any
  384.             incoming echomail into its proper areas.  Any incoming mail
  385.             destined to be sent on to other systems will also be prepared for
  386.             packing.  The combined "Toss" and "Scan" modes activate Qmail's
  387.             Passthru recognition so that any passthru messages will be deleted
  388.             immediately after the pass is completed.  NORMAREA.BBS is the file
  389.             containing all the echomail information for that zone.
  390.  
  391.                  Next Qmail is run again in "Scan" mode which will cause Qmail
  392.             to search all echomail areas for any new mail that might have
  393.  
  394.  
  395.                       Connect v1.00  Documentation  ---  Page 6
  396.  
  397.  
  398.  
  399.  
  400.  
  401.             originated on your system.  This pass is necessary since the
  402.             previous "Toss Scan" pass will only handle incoming mail, not new
  403.             mail entered on your system.
  404.  
  405.                 Qmail is then run a third time in "Pack" mode to pack any mail
  406.             waiting to be sent on to other systems.  NORMAL_MAIL is the tag of
  407.             the schedule used to control packing as defined in your Qmail
  408.             Routing file (typically QM_ROUTE.CFG).
  409.  
  410.                  Connect is run lastly to generate the required file-attach
  411.             messages for any new outgoing mail packets.  The whole process is
  412.             then repeated using the next zone's set of control files.
  413.  
  414.  
  415.  
  416.        CONNECT.CTL VERBS
  417.  
  418.             Following is a listing of each verb in CONNECT.CTL along with their
  419.        meaning.
  420.  
  421.        HOLDDIR  <directory>   The complete path to your Qmail outbound
  422.                               directory.
  423.  
  424.        NETMAIL  <directory path>  The complete path to your NetMail
  425.                                   message directory.
  426.  
  427.        ZONE  #   The zone your system operates in.  This must be the same as
  428.                  the primary zone defined in the Qmail "Pack" configuration
  429.                  file for that zone.
  430.  
  431.        NET   #   The Net number of your system.  This must be the same as the
  432.                  primary net address defined in the Qmail "Pack" configuration
  433.                  file for that zone.
  434.  
  435.        NODE  #   The Node number of your system.  This must be the same as the
  436.                  primary node address defined in the Qmail "Pack" configuration
  437.                  file for that zone.
  438.  
  439.  
  440.  
  441.  
  442.  
  443.  
  444.  
  445.  
  446.  
  447.  
  448.  
  449.  
  450.  
  451.  
  452.  
  453.  
  454.  
  455.  
  456.  
  457.  
  458.  
  459.  
  460.  
  461.                       Connect v1.00  Documentation  ---  Page 7
  462.